home *** CD-ROM | disk | FTP | other *** search
/ The Atari Compendium / The Atari Compendium (Toad Computers) (1994).iso / files / prgtools / mint / mntdoc01.zoo / mintdoc / cat3 / symlink.3 < prev    next >
Encoding:
Text File  |  1993-03-03  |  1.5 KB  |  67 lines
  1.  
  2.  
  3.  
  4. SYMLINK(3)          MINTLIB LIBRARY FUNCTIONS          SYMLINK(3)
  5.  
  6.  
  7. N✓NA✓AM✓ME✓E
  8.        symlink - make symbolic link to a file
  9.  
  10. S✓SY✓YN✓NO✓OP✓PS✓SI✓IS✓S
  11.        #include <support.h>
  12.  
  13.        int symlink(const char *old, const char *new);
  14.  
  15. D✓DE✓ES✓SC✓CR✓RI✓IP✓PT✓TI✓IO✓ON✓N
  16.        A  symbolic link new is created to old (new is the name of
  17.        the file created, old is the string used in  creating  the
  18.        symbolic link). Either name may be an arbitrary path name;
  19.        the files need not be on the same file system.
  20.  
  21.        The file that the symbolic link points to is used when  an
  22.        open  operation is performed on the link. A stat on a sym-
  23.        bolic link returns the  linked-to  file,  while  an  lstat
  24.        returns  information  about the link itself. This can lead
  25.        to suprising results when a symbolic link  is  made  to  a
  26.        directory.  To  avoid  confusion in programs, the readlink
  27.        call can be used to read the contents of a symbolic  link.
  28.  
  29. R✓RE✓ET✓TU✓UR✓RN✓N V✓VA✓AL✓LU✓UE✓ES✓S
  30.        symlink returns:
  31.  
  32.         0  on success -1 on failure; errno is set to indicate the
  33.        error
  34.  
  35. S✓SE✓EE✓E A✓AL✓LS✓SO✓O
  36.        l✓li✓in✓nk✓k(✓(3✓3)✓),✓, r✓re✓ea✓ad✓dl✓li✓in✓nk✓k(✓(3✓3)✓),✓, u✓un✓nl✓li✓in✓nk✓k(✓(3✓3)✓),✓, F✓Fs✓sy✓ym✓ml✓li✓in✓nk✓k(✓(2✓2)✓)
  37.  
  38. N✓NO✓OT✓TE✓ES✓S
  39.        MS-DOS (TOS) file-systems do not support symbolic links.
  40.  
  41.        The file or directory linked to (old) need not exist.
  42.  
  43.  
  44.  
  45.  
  46.  
  47.  
  48.  
  49.  
  50.  
  51.  
  52.  
  53.  
  54.  
  55.  
  56.  
  57.  
  58.  
  59.  
  60.  
  61.  
  62.  
  63.  
  64. MiNT docs 0.1              3 March 1993                         1
  65.  
  66.  
  67.